home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / printer-studio / canon studio / canonstudio / readme < prev    next >
Text File  |  1992-09-08  |  46KB  |  1,238 lines
  1.  
  2.  
  3.                  C A N O N S T U D I O  V 1.1
  4.                  ============================
  5.  
  6.  
  7.  
  8.                           COPYRIGHT
  9.                           ---------
  10.  
  11. COPYRIGHT   ©   1992   WOLF  FAUST.   ALL  RIGHTS  RESERVED.   ALL
  12. DISTRIBUTION-  AND  MARKETING RIGHTS TO THE SOFTWARE ARE VESTED IN
  13. WOLF FAUST.
  14.  
  15. COPYRIGHT:    THIS  PRODUCT  ("CANONSTUDIO")  IS  COPYRIGHTED  AND
  16. OTHERWISE  SUBJECT  TO  PROPRIETY  RIGHTS.   YOU  MAY NOT COPY, OR
  17. TRANSFER  THE  PRODUCT  OR  ANY  COPY  OR  PORTION THEREOF WITHOUT
  18. WRITTEN PERMISSION FROM THE AUTHOR WOLF FAUST.
  19.  
  20. DISCLAIMER:   THE  PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  21. ANY  KIND, EITHER EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE.  THE
  22. ENTIRE  RISK  AS TO USE, RESULTS AND PERFORMANCE OF THE PRODUCT IS
  23. ASSUMED BY YOU.
  24.  
  25. LIMITATION OF LIABILITY:
  26. IN  NO  EVENT  SHALL  CANON  AND/OR FAUST OR ITS SUPPLIERS BE HELD
  27. LIABLE  FOR  ANY  LOSS  OR DAMAGES ARISING OUT OF ANY ACTION, FROM
  28. WHATEVER  SOURCE,  CONCERNING  THE  USE  OR  INABILITY  TO USE THE
  29. PRODUCT.
  30.  
  31.  
  32.  
  33.                           REGISTERING
  34.                           -----------
  35.  
  36. Please  register  CanonStudio or this product will most likely not
  37. be  supported  in  the  future (programs do cost more than time to
  38. develop).  Also, your sharefee is my motivation for enhancements.
  39.  
  40. The price for registering is:
  41.  
  42.  
  43.                        INTERNATIONAL
  44.  
  45.         US$25   includes shiping
  46.       +   $ 5   if payed by cheque. No COD!
  47.  
  48.  
  49.  
  50.                          GERMANY
  51.  
  52.         DM 35   includes shiping. No COD (Nachnahme)!
  53.  
  54.  
  55.  
  56.                          ENGLAND
  57.           £15   includes shiping
  58.  
  59.  
  60.  
  61. Send the money to following address:
  62.  
  63. Wolf Faust
  64. Am Dorfgarten 10
  65. W-6000 Frankfurt 50
  66. Germany
  67.  
  68. Tel: ++49-69-5486556 (GMT)
  69. Fido:       2:249/3.5 (Wild Cat: ++49-6173-2544 HST,V.32bis)
  70. email:   wfaust@aurea.hotb.sub.org
  71.  
  72.  
  73. Or in England you may register and get updates at/from:
  74.  
  75. JAM
  76. Jeff Walker
  77. 75 Greatfields Drive
  78. Uxbridge, UB8 3QN
  79.  
  80. Tel: 08952-74449 (GMT)
  81.  
  82. What do you get in return:
  83.  
  84. - CanonStudio registered version
  85. - .030 version (approx. 10-20% faster)
  86. - update service (I take that very serious!)
  87.  
  88.  
  89.  
  90.  
  91.                           TRADEMARKS
  92.                           ----------
  93.  
  94. Amiga is a registered trademark of Commodore-Amiga, Inc.
  95. Kickstart is a registered trademark of Commodore-Amiga, Inc.
  96. Workbench is a registered trademark of Commodore-Amiga, Inc.
  97. Deluxe Paint is a registered trademark of Electronics Art.
  98.  
  99. All  other  trademarked  product and company names used herein are
  100. used   for  identification  purposes  only.   No  infringement  of
  101. trademarks   is  intended.   Trademarks  remain  property  of  the
  102. trademark holder.
  103.  
  104.  
  105.  
  106.                         INTRODUCTION
  107.                         ------------
  108.  
  109. CanonStudio is a new program which is intended for all Amiga Canon
  110. printer  drivers.   It  does  print IFF graphics with up to 24 bit
  111. color   accuracy   in   any  size  (Want  a  100*100m  poster?)  .
  112. CanonStudio  is  not limited to the max.  4096 colors of the Amiga
  113. printer  device, though it does work with nearly all Amiga printer
  114. drivers.   The  pictures are printed FROM DISK ie.  you don't need
  115. much memory for printing a 10MByte 24 Bit graphic in high quality.
  116.  
  117. CanonStudio  is  specially  written for the Amiga operation system
  118. and  is not just a simple portation from an IBM or Apple computer.
  119. Because  of  this, CanonStudio makes heavy use of multitasking and
  120. Kickstart  2.04.   CanonStudio includes a spooler which allows you
  121. to  specify  multiple  print  jobs  while  the  program is already
  122. printing   in   background.   The  program  does  provide  a  nice
  123. "click-and-drag" user interface and an ARexx interface.
  124.  
  125. From  my  experience,  most Canon printer owners do print pictures
  126. using  ADPro's  PrefPrinter  saver or TruePrint.  CanonStudio does
  127. offer  users  an easy and inexpensive way for printing pictures in
  128. high  quality.   Using  the  ARexx-Interface,  CanonStudio  can be
  129. controlled   by   other   programs   like  ADPro  or  Black  Belts
  130. Imagemaster.
  131.  
  132. Now, here are some of the CanonStudio features:
  133.  
  134. - prints IFF ILBM pictures from disk
  135.  
  136. - supports most of the known IFF ILBM formats, including HAM8,
  137.   HAM, EHB and color palettes up to 256 colors.
  138.  
  139. - does not require $&%$ MBytes memory!
  140.  
  141. - Allows you to print poster size images spread over multiple
  142.   pages.
  143.  
  144. - number of copies can be defined
  145.  
  146. - Using  CanonStudio you  can  print 24 bit-planes of color accuracy
  147.   on  a  color  printer  (for  instance CanonBJC800).  If you have a
  148.   black and white only printer, then you can print with 8 bit-planes
  149.   of grey scale accuracy.
  150.  
  151.  
  152. - multiple jobs can be defined and printed in background
  153.   (estimated print time and more will be displayed)
  154.  
  155. - ink compensation does correct ink impurities
  156.  
  157. - color adjustment (gamma, contrast, brightnes, weights,...)
  158.  
  159. - Free defineable ordered dither routines. Following ordered
  160.   dither matrices are already included:
  161.   Haltone-A, Halftone-B, Ordered-A, Ordered-B, Spiral, Horizontal,
  162.   Vertical, Bck-Diagonal, Fwd-Diagonal
  163.  
  164. - Three error diffusion dither routines:
  165.   Floyd Steinberg, Jarvis, Stucki
  166.  
  167. - Two serpentine blue noise dither routines are included:
  168.   30% random weight, 50% random weight
  169.  
  170. - ARexx Interface
  171.  
  172. - font independent user interface (KS 2.04 style)
  173.  
  174.  
  175.  
  176.                         ABOUT THIS MANUAL
  177.                         -----------------
  178.  
  179. Sorry for this limited manual.  I'm sure most things can easily be
  180. understood  by  simply using the "try and error" method.  I simply
  181. don't have the time yet to describe all those nice features hidden
  182. in  the  program in detail.  This will hopefully be addressed in a
  183. future  release.  Nearly every function is covered by this manual,
  184. though, most things should be better explained.
  185.  
  186.  
  187.                            HISTORY
  188.                            -------
  189.  
  190. Following driver revisions have been made:
  191.  
  192. 05.09.92     Version 1.0  First Version
  193. 08.09.92     Version 1.1  "Vertical Aspect" set in preferences
  194.                           caused wrong sized printing
  195.                           (a left bar) - fixed
  196.  
  197.  
  198.  
  199.                           INSTALLATION
  200.                           ------------
  201.  
  202. What does CanonStudio requires:
  203.  
  204. - an Amiga with at least Kickstart/Workbench 2.04
  205. - ~300KB memory (so it even runs on a plain Amiga 500)
  206. - a Canon printer driver (at least CanonBJ130 V11.1, CanonBJ10 V4,
  207.   CanonBJC V1, CanonLBP V3, CanonBJ300 V4.1)
  208.  
  209. For  installing  CanonStudio  simply drag the CanonStudio icon and
  210. Dither-Settings  drawer  into  the  wanted  drawer.  That's all...
  211. simple, isn't it?
  212.  
  213. WARNING: IF STARTED FROM WORKBENCH, MAKE SURE STACK IS SET TO AT LEAST
  214. 10000   BYTES   OR  CANONSTUDIO  WILL  CRASH!!!
  215.  
  216. In case you have the original icon as distributed, stack is set to
  217. 10000   allready.   Stack  can  be  set  using  the  "Information"
  218. workbench   menu.    When   started  from  Shell/CLI,  CanonStudio
  219. automaticly allocates it's stack.  Because of this, you don't need
  220. to set stack from Shell/CLI.
  221.  
  222.  
  223.  
  224.                       LAUNCHING CANONSTUDIO
  225.                       ---------------------
  226.  
  227. CanonStudio  may be run from either Workbench or a Shell.  When it
  228. starts,   it   looks   for   a   file   in  its  directory  called
  229. "CanonStudio.prefs"   that  contains  your  last  used  and  saved
  230. settings for printing.  In case the setting file can not be found,
  231. CanonStudio  uses  it's  default  internal settings.  You may also
  232. have your own settings file.
  233.  
  234. CanonStudio can be launched from Workbench by double clicking on
  235. its icon. The CanonStudio icon has one tool type to specify its
  236. setting file.
  237.  
  238. The tool type is
  239.  
  240.             SETTINGS=<settingsfile>
  241.  
  242. where <settingsfile> is the name of a settings file for CanonStudio
  243. preferences. The default settings file is "CanonStudio.prefs" in
  244. the program directory containing the CanonStudio executable.
  245. Also, there are several tool type options which allow you to
  246. override the settings of the settings file. These options are
  247. named the same way as the Shell options are descibed below in
  248. detail.
  249.  
  250. From a  Shell, CanonStudio is invoked by typing "CanonStudio".
  251. CanonStudio has the following command template for it's arguments.
  252.  
  253.  
  254. CanonStudio PUBSCREEN/K,TOPAZ/S,REXX/S,NOFILEREQ/S,SCALE/S,
  255.             NOSCALE/S,SETTINGS/K,PRI=PRIORITY/K/N,UNIT/K/N,FILES/M
  256.  
  257. where SETTINGS is the name of a settings file for CanonStudio
  258. preferences.
  259.  
  260. Beside the SETTINGS option, both, tool type and shell argument can
  261. be used to override special preference settings or cause a
  262. different behaviour of CanonStudio:
  263.  
  264. PUBSCREEN <Name>
  265. allows opening CanonStudio on a public screen.
  266.  
  267. TOPAZ
  268. disable  independent font code.  CanonStudio will only use Topaz 8
  269. for rendering it gadgets.
  270.  
  271. REXX
  272. Will  open  ARexx  port after FILES/M got processed.  WARNING:  if
  273. REXX is specified, you can only quit CanonStudio by using the QUIT
  274. or CONITNUE command (see the ARexx-Interface chapter).
  275.  
  276. NOFILEREQ:
  277. If  files  are  specified during startup, these will be processed.
  278. No  filerequester  appears  after this and -- unless REXX has been
  279. specified -- CanonStudio is terminated.
  280.  
  281. FILES <name1> <name2>... :
  282. You may specify files for processing and printing.
  283.  
  284. SCALE|NOSCALE  (default SCALE)
  285. In  case  SCALE  is  used,  CanonStudio  checks  if  the  IFF CMAP
  286. (colormap)  was shifted or scaled.  Some application programs (for
  287. instance  DPaint  4.1)  do write their color values shifted (0xF0)
  288. instead  of  scaled (0xFF) causing to dark colors.  As default you
  289. should  start  CanonStudio  with  the  SCALE  option  and save the
  290. setting.   Newer  programs do write their color values scaled (for
  291. instance  ADPro).   Usually do not care about this setting, except
  292. you get light grey instead of a white area.
  293.  
  294. PRI=PRIORITY <num>  (Default -1)
  295. Defines  the  process  priority  of  the  main  print process.  As
  296. default  a  value  of  -1  is  set.   This  results  in  a  better
  297. multitasking  behaviour as you may go further while CanonStudio is
  298. printing  in  background.   Most  Amiga  processes  have  a higher
  299. priotity of 0. The priority must be in range from -50 to 50.
  300.  
  301. NOTE:  In case there is an other task with higher priority running
  302. in  background,  CanonStudio  may  seem to be disabled or crashed,
  303. though  this  is  not the case simply because CanonStudio does not
  304. get  any computing time because of it's lower priority compared to
  305. the  other  task.   In this case quit or halt the other task while
  306. CanonStudio is running, or increase the CanonStudio priority using
  307. the PRIORITY option.
  308.  
  309. UNIT <num>     (Default 0)
  310. Future  Workbench  printer preferences may allow you top specify a
  311. printer  port  to  print  at.  Also, most of the current multiport
  312. cards  allow  you  to  specify a port for printing at using a unit
  313. number  (ie.  0 = internal port, 1 = external port A, 2 = external
  314. port B,...).
  315. Using the UNIT tool type or CLI keyword, you can define a unit
  316. (ie. port) to print at. As default, unit 0 is used.
  317. Once specified you can save the unit in the CanonStudio settings
  318. file.
  319.  
  320.  
  321. NOTE:   in  case  the settings file could not be read, CanonStudio
  322. automaticly   sets   the   dither   method   to  custom  with  the
  323. Ordered-A-256  dither  method  installed.   So  the first time you
  324. start, Ordered is installed as "Custom Dither".
  325.  
  326.  
  327.                            GETTING STARTED
  328.                            ---------------
  329.  
  330. After starting CanonStudio a filerequester appears and ask you for
  331. selecting IFF files for printing.  You can avoid the filerequester
  332. by specifying files as arguments on shell startup, and/or by using
  333. the NOFILEREQ option.
  334.  
  335. Also,   in   case   you  start  CanonStudio  from  Workbench,  the
  336. filerequester  can  be avoided by multiselecting the picture icons
  337. (see your system manual for more information).
  338.  
  339. In  either  case,  Shell  or  Workbench,  a filerequester does not
  340. appear  in  case  you  already  have  specified a picture file on
  341. startup.   In case no file is given, the filerequester appears and
  342. you   can   multiselect   (again,   see  your  system  manual  for
  343. multiselection) files for printing.
  344.  
  345. In  case  you  are  not  sure about printing a special file, don't
  346. hesitate.   Unless  you  have  specified  the  NOFILEREQ option on
  347. startup,  the filerequester will appear again after processing the
  348. other given files.
  349.  
  350.  
  351.                         THE MAIN PROCESS WINDOW
  352.                         -----------------------
  353.  
  354. After  successfully  selecting  the  file(s), the two main process
  355. windows  open.  One window is sized as far as your monitor allows.
  356. This window gives you an overview of the size of the printing page
  357. and  the  picture size and position for printing.  You can use the
  358. mouse to position and size the picture on page.
  359.  
  360. While  you  use the mouse for positioning the picture on the page,
  361. the  gadgets  in the second window are updated accordingly.  These
  362. gadgets  show  the extact numeric values of the selections made by
  363. mouse in the other window.
  364.  
  365. Also,  this  smaller  window  contains all the gadgets you need to
  366. control  color, dither method and more.  Most of the gadgets don't
  367. need  a  huge  explanation,  so  let's have an overview over these
  368. gadgets:
  369.  
  370.  
  371.  
  372.  
  373. Paper Dimension:
  374. These  are  two  gadgets.   One  is  showing  you the width of the
  375. maximum  printable  area  of your printer as yelled by the printer
  376. driver.   This  gadget is read-only.  The other gadget defines the
  377. height  of  the  maximum  printable  area  of  your printer.  This
  378. setting is often defined as physical print page.  For instance, in
  379. case  you  have a DIN A4 paper with a size of 21.0*29.7cm and your
  380. printer always leaves a top and bottom border of 1 cm, you should
  381. enter 27.7cm here.
  382.  
  383.  
  384.  
  385.  
  386. Page Dimension:
  387. Now  that  you have defined the maximum print area of your printer
  388. for  a  given  paper  size,  you may define a wanted subpage.  For
  389. instance, you may want to decrease the printable size if you have
  390. a  DIN  A4  sized paper with sign at the top which should never be
  391. overprinted  (or  a formular paper).  Let's say the sign is at the
  392. top  border  and  2  cm height.  Now you should decrease the print
  393. height  from  Paper  Dimension  by  two (ie.  25.7cm) and define a
  394. border of 2 cm at the top (Page Dimension Y = 2cm).
  395.  
  396.  
  397.  
  398.  
  399. Print Dimension:
  400. And  finaly  we have the actual print size of the picture.  The is
  401. nearly  no  limit  to  the  size specified here.  Just be sure the
  402. upper left corner of the picture will be printed on the first page
  403. (if  not,  you'll  get  an  error requester anyway...).  The Print
  404. Dimensions X will be applied to all of the left-most pages in a
  405. poster print.  All of the top most pages of a poster print will be
  406. affected by the Print Dimensions Y setting.
  407.  
  408.  
  409.  
  410. Density:
  411. This  cycle  gadget in the upper right of the window shows you the
  412. densities  supported  by  the  printer  driver.   Select  a wanted
  413. density by simply clicking with the mouse on the gadget.
  414.  
  415.  
  416.  
  417. Col / b/w
  418. Below the Density gadget, you find the color and b/w cycle gadget.
  419. This gadget allows you to select the output of a color picture:
  420. greyscale or color. In case you select color and your printer
  421. driver does not support color, greyscale is used automaticly.
  422.  
  423.  
  424.  
  425.  
  426. Single/Fanfold
  427. This   gadget   does   the   same  as  the  Workbench  preferences
  428. Single/Fanfold  gadget.  In case Single is selected, a Formfeed is
  429. send  after  each  page.   Fanfold  should  be used for endless or
  430. rolled paper.
  431. If  you have a single sheet ONLY printer like a laser printer, you
  432. can  use  FanFold to print multiple pictures on one page.  Just be
  433. sure  to set the page and paper dimension accordingly.  If you are
  434. printing  a  multicolumn  poster  on  continuous paper (fanfold or
  435. roll)  then  you  would  set  "Fanfold" and define some top margin
  436. (Print  Dimensions  Y)  so  that the columns of your print will be
  437. separated.   Also,  when printing posters on continuous paper, you
  438. should  set  the Page Definitions Top margin to 0 so that there is
  439. no gap between individual pages of a column.
  440.  
  441.  
  442.  
  443.  
  444.    Custom/Floyd/Stucki/Jarvis/Blue Noise 30%/Blue Noise 50%
  445.  
  446. This cycle gadget allows you to select a wanted dither method.
  447. The dither method themselves are discussed later in detail.
  448. However, the print time increases with the dither method listed
  449. below. For instance Blue Noise usually requires twice the print
  450. time of the any Custom dither.
  451.  
  452. o  Custom  allows  you  to define any wanted ordered dither matrix
  453. using  the  "Define  Dither"  gadget  below.   Many preset ordered
  454. dither matrixes are provided and explained later in detail
  455.  
  456. o Floyd Steinberg is a very popular error diffusion dither method.
  457. This  dither  method  does  provide a good compromiss of speed and
  458. quality.
  459.  
  460. o  Stucki  is also an error diffusion dither method.  Different to
  461. Floyd Steinberg, this dither does require more computing time as a
  462. result of taking more pixels into the account.
  463.  
  464. o  Jarvis  is  also  an error diffusion algorithem with nearly the
  465. same  output  as the Stucki dither.  The added computation time of
  466. the Jarvis and Stucki dithers results from incorporating a greater
  467. number of pixels into each dithering computation.
  468.  
  469. o Blue Noise 30%
  470. This  is  an  error  diffusion  algorithem with perturbation and a
  471. serpentine raster using the Floyd Steinberg filter with 30% random
  472. weights.
  473.  
  474. o Blue Noise 50%
  475. This  is  an  error  diffusion  algorithem with perturbation and a
  476. serpentine raster using the Floyd Steinberg filter with 50% random
  477. weights.
  478.  
  479. If  you  want  to  read  more  about  dither  routines and digital
  480. halftoning, here is a very good book to go for:
  481.  
  482. Robert Ulichney
  483. "Digital Halftoning"
  484. MIT Press
  485. ISBN 0-262-21009-6
  486.  
  487. The  book  is  easy  to  understand  and  does  come with lot's of
  488. samples.   Most of the dither routines described below are handled
  489. in  detail  in  this  book.   Surely one of the best books when it
  490. comes to digital halftoning.
  491.  
  492.  
  493.  
  494.  
  495. Color Adjust...
  496. A window will appear when you click on this gadget. The window
  497. contains many sliders giving you a possibility of to control the
  498. color, brightness and more of your picture. While most functions
  499. should be known, some note should be made:
  500.  
  501. -  the  gamma  sliders  allows  you to bright up a picture without
  502. loosing  to  much  colors.   Specially owners of printers with dot
  503. gain  problems  (most  "cheap"  printers  <$3000  do have dot gain
  504. problems!)  should  use  this  slider  to increase the brightness.
  505. Usually, you should select a value from 20-30 for best printing on
  506. the CanonBJC800, BJ10, BJ300. 
  507.  
  508.  
  509. - the weights sliders are importend for printing color pictures on
  510. greyscale printers.  The color components of the color picture are
  511. weighted  accord  to  the  slider settings.  What are weights good
  512. for?  A red and green pixel, both with the same color value of 50,
  513. do  not have the same luminance when they are displayed on a color
  514. monitor.   Most likely the green will look brighter because of the
  515. way  monitor  tubes are build.  Because of this, when converting a
  516. color  picture  previously  displayed  on a monitor to a greyscale
  517. picture,   you   have  to  consider  the  different  weights  (ie.
  518. luminance)  of  the tube colors.  As default, CanonStudio uses the
  519. weights as defined by the NTSC and PAL standard.  In case you have
  520. scanned  a picture with a RGB scanner, the colors are not weighted
  521. to  these  standards and are most likely weighted equaly.  In this
  522. all  sliders  should  be  set to 3333 (ie.  33.33%) resulting in a
  523. total weight of 100%.  The total weighting may exceed 100 percent.
  524.  
  525. -  CanonStudio  also offers the user complete control over its ink
  526. compensation  function.   Printer's  inks  are not completely pure
  527. materials.  For example, there is some amount of yellow mixed into
  528. the  magenta  ink.   And,  there  is  some amount of magenta which
  529. unavoidably is found in the cyan ink.  The ink compensation values
  530. will  correct for these impurities.  With Magenta Compensation you
  531. define  the  amount  of  magenta in the cyan ink in percent.  With
  532. Yellow Compensation you define the amount of yellow in the magenta
  533. ink  in  percent.   In  general, set the ink compensation value of
  534. magenta  31%  and  yellow to 40% for best results with Inkum Inks.
  535. PS:   on  my  experience  15%  gives better violet shades with the
  536. original  Canon  BJC800  inks, but again...  it's best you ask the
  537. manufacturor  of  the  ink  for  the right values.
  538.  
  539. NOTE:  The ink compensation function can be completely disabled by
  540. defining  0%.   You  will notice that without the ink compensation
  541. function,  a  blue  sky  will  print  as  purple.   With  the  ink
  542. compensation function set at 31%, blue skies are blue again.
  543.  
  544.  
  545.  
  546. Set Aspect
  547. When  you click on this gadget, CanonStudio automatically sets the
  548. print  height  of  your  picture  to  a value so that your printed
  549. picture does have the right aspect ratio.  This requires a correct
  550. aspect  ratio  or  DPI chunk saved in your picture.  After setting
  551. the  correct  aspect  ratio,  a  circle is printed as circle and a
  552. square  would  be  printed  as  square no matter what the physical
  553. aspect of the printer's dots are.
  554.  
  555.  
  556.  
  557. cm/inch
  558. Every  value  shown  in  the windows can defined as centimeters or
  559. inches.   This  gadget  shows  the  current selection and when you
  560. click on it, all values are changed to the other measurement.
  561.  
  562.  
  563. Copies
  564. Allows you to define the number of copies you wish to print of the
  565. picture.
  566.  
  567.  
  568. Startin page
  569. In case you print a poster, you may define a page to start
  570. printing with. This is specialy usefull for printing posters. In
  571. case you had some trouble with the printer in the middle of the
  572. printing (out of paper?), you may restart the printing with the
  573. page aborted.
  574.  
  575.  
  576.                        PRINTING THE PICTURES
  577.                        ---------------------
  578.  
  579. After  all settings have been done in the main process window, you
  580. can  click  on  the  "Print"  button.   A small status window will
  581. appear  telling  you  the  number  of pages, copies and after some
  582. seconds the estimated printing time.
  583.  
  584. CanonStudio  includes  a  printer  spooler  of  it's  own  (called
  585. MultiTasking  hihi).   Because  of  this,  you can go further with
  586. selecting  pictures  for  printing  while  the  printer  is  still
  587. printing.  The main window will appear with the next picture file
  588. in case you selected multiple pictures on startup. After defining
  589. the print size of all given pictures, the filerequester appears
  590. again.
  591.  
  592. There  is  nearly  no  limit  in  predefining multiple print jobs!
  593. Also,  you  can  define  the  priority  of the printing process on
  594. startup  of  CanonStudio  and save this setting by clicking on the
  595. "Save  Setting" gadget.  If you set this priority to a less than 0
  596. (default  -1),  printing  is done in background without disturbing
  597. you  while  defining the print dimension of the next picture or do
  598. whatever you like to do with your Amiga (except power off ;-).
  599.  
  600.  
  601.                          QUIT CANONSTUDIO
  602.                          ----------------
  603.  
  604. You  can  terminate  CanonStudio by clicking on the filerequesters
  605. close gadget or the Quit gadget.
  606.  
  607.  
  608.  
  609.                          THE STATUS WINDOW
  610.                          -----------------
  611.  
  612. The status window appears on startup of CanonStudio and remains
  613. open until you quit CanonStudio. While printing the window is
  614. sized to its maximum size and shrinked to a small title bar while
  615. not printing. The status window displays the current print job in
  616. progress and estimated printing time.
  617. Two gadgets are in this window and enabled in case a picture is
  618. printed:
  619.  
  620. "Aborts" the printing of all pictures.
  621. "Skip"  skips the current picture and printing will start with the
  622. next picture.  Also, a requester appears to make sure your printer
  623. is ready for the next picture in case of an previous problem.
  624.  
  625.  
  626.  
  627.                           PRINTER DRIVERS
  628.                           ---------------
  629.  
  630. CanonStudio  was designed to work with most Amiga printer drivers.
  631. Though,  as  result  of the major efforts from Canon in supporting
  632. the  Amiga,  currently  only Canon users get the program for free.
  633. Because  of  this,  CanonStudio  was  limited  to  work with Canon
  634. drivers. In case the printer driver support it's own kind of color
  635. adjustment or dither routines: turn them off! Usually this can be
  636. easily done by printing using density 1 or 2. See your printer
  637. driver manual for more details.
  638.  
  639.  
  640.                           DITHER ROUTINES
  641.                           ---------------
  642.  
  643. Many  dithering  methods are supplied with the CanonStudio.  These
  644. are  described  below.   In  each  case  a larger dither mask size
  645. produces  a  print which can represent a wider range of colors but
  646. will  produce  less  spatial  information  per unit area of paper.
  647. Conversely,  a smaller dither mask size can reproduce fewer colors
  648. (or  shades)  but more closely approximates the true resolution of
  649. your printer.
  650.  
  651. Another  way  of  expressing  this  is  the following:  There is a
  652. tradeoff  between printing ``lots'' of colors and printing in high
  653. resolution.    Given  a  specific  printer  with  a  specific  DPI
  654. capability,  asking  for  ``lots''  of colors means using a larger
  655. dither  mask  size.   A  larger dither mask size cuts down on your
  656. effective  resolution.  For instance, using a dither mask of 16*16
  657. on  your 360dpi printer will result in 360/16 = 22.5 dpi with full
  658. color information.
  659.  
  660. Note  that  this can work to your advantage when blowing a picture
  661. up  in  size.  Blowing up a picture means that there are more dots
  662. to  work  with  which  offsets  the loss in resolution caused by a
  663. larger  dither mask size.  This added to the benefits to be had by
  664. being  able  to  reproduce more colors (or shades) means that your
  665. enlarged posters will look quite good.
  666.  
  667. Also note that many printers including most laser printers and dot
  668. matrix  printers  have  considerable dot gain.  For example, a 360
  669. DPI  laser printer does not actually print dots which are 1/360 of
  670. an  inch  in  size.   Rather,  its dots will be much larger.  This
  671. causes  some  dithers,  such  as  the  Floyd-Steinberg and Ordered
  672. dithers,  to  produce  intensely  over-saturated  or muddy prints.
  673. Other  dithers  such  as  the  two  halftone dithers overcome this
  674. problem with low-end printers.
  675.  
  676. Also,  if  you want to read more about dither routines and digital
  677. halftoning, here is a very good book to go for:
  678.  
  679. Robert Ulichney
  680. "Digital Halftoning"
  681. MIT Press
  682. ISBN 0-262-21009-6
  683.  
  684. The  book  is  easy  to  understand  and  does  come with lot's of
  685. samples.   Most of the dither routines described below are handled
  686. in  detail  in  this  book.   Surely one of the best books when it
  687. comes to digital halftoning.
  688.  
  689. Now let's take a look at the supplied dither routines. 
  690.  
  691.  
  692.  
  693.                            Custom
  694.                            ------
  695.  
  696. If the Custom dither method is selected, you can define or load
  697. any ordered dither matrix by click on the "Define Dither" method
  698. below the gadget. Several popular ordered dither method are
  699. provided with CanonStudio and saved in a file. These file can be
  700. loaded and enabled with the "Load" gadget.
  701.  
  702. The  amount of printable colors is usually directly related to the
  703. size  of the dither matrix.  The ordered dither routines described
  704. below  usually  exists  in several sizes.  You can distinguish the
  705. custom ordered dither routines by their filenames.  For instance a
  706. filename  of  "Halftone-A-4"  means:  Halftone A dither routine, 4
  707. shades.  While "Halftone-A-256" means:  Halftone A dither routine,
  708. 256 shades.
  709.  
  710.  
  711.               Halftone-A - <number of colors>
  712.               Halftone-B - <number of colors>
  713.  
  714.  
  715. The  halftone  dithers  (Halftone-A  and Halftone-B) differ in how
  716. they place a halftone matrix.
  717.  
  718. This  is the classical clustered halftone method used by most book
  719. publishers.   To improve the dither output, the halftone matrix is
  720. rotated  by  45 degree.  Halftone-A causes the halftone matrix for
  721. each  of  the  primary colors to be centered about the same point.
  722. This  means  that  the  primary  colors  will  overlap completely,
  723. leaving  a  lot  of  white  paper  showing  through.   This may be
  724. appropriate for some better dye sublimation type printers or other
  725. color printers with good registration where the inks mix well.
  726.  
  727. Halftone-B,  on  the  other  hand, staggers the halftone matrix of
  728. each  primary  color so that they do not overlap.  This is similar
  729. in  concept  to traditional color offset printing.  Halftone-B may
  730. produce better results on printers whose inks do not mix well, and
  731. on printers with less than perfect registration.
  732.  
  733. The  halftone dithers can produce some extremelly good results and
  734. compensate  for  the  dot  gain problems outlined above.  Try both
  735. halftone  dithers  to  see which one is better for your particular
  736. intention.
  737.  
  738. Also, in case you xerox your printing, using Halftone results in a
  739. much better copy.
  740.  
  741. To  use  Halftone-B  is  somehow  different  to  the  other dither
  742. matrices.   You  have  a  special  dither  matrix  for each color.
  743. Because of this, each dither filename includes the abbreviation of
  744. the  color  (C  =  cyan,  Y  =  yellow,  M = magenta, K = black or
  745. greyscale).   In case you use Halftone-B you also have to increase
  746. the  brightness  of  the  black  color  component by 50%.  Use the
  747. bright+ gadget in the CanonPref program for increasing brightness.
  748.  
  749. Halftone-B is a nice example for the relationship between color
  750. adjustment and dither routines. You have to consider both setting
  751. up your driver.
  752.  
  753.  
  754.  
  755.  
  756.                  PrtDevice-Halftone-16
  757.                  PrtDevice-Ordered-16
  758.  
  759.  
  760.  
  761. This dither matrix is the one used by the printer devices
  762. "Halftone" or "Ordered" dither.
  763.  
  764.  
  765.  
  766.                  Ordered-A - <number of colors>
  767.  
  768.  
  769.  
  770. The  ordered  dither produces a regular repeating pattern which is
  771. often  used for printing computer graphics.  The ordered dither is
  772. particularly  susceptible  to  over-saturation  due to dot gain in
  773. high resolutions. Though, you surely get nice outputs in 180DPI.
  774.  
  775.  
  776.                  Ordered-B - <number of colors>
  777.  
  778. This  dither  is  a mixture of a dispersed dither like Order and a
  779. clustered  dither like Halftone.  The dither is specialy addressed
  780. to  the  high  resolution  printers  with  dot gain problems.  For
  781. instance,   if   you  print  a  picture  with  360*360  dpi  using
  782. Ordered-Rect-B-64, you get a picture that seems to be printed with
  783. 180*180  dpi.   Now  while  graphics are printed emulating 180*180
  784. dpi,  all  black  parts  of the picture are printed using 360*360.
  785. Don't  be  confused,  the  printed  picture  is  still better than
  786. a     picture     in     real    180*180dpi    resolution.     The
  787. Ordered-Rectangular-B is specialy usefull for color DTP. You get
  788. nice color pictures with fine high quality text.
  789.  
  790.  
  791.  
  792.             Spiral-Dot-Screen  - <number of colors>
  793.  
  794.  
  795. A  wide  range  of  special  effects clustered dither matrices are
  796. available  in  the  graphic  arts  industry  and  all  are  easily
  797. simulated digitally.  Spiral-Dot is such a dither.
  798.  
  799. The spirol-dot dither is essentially half of the classical screen,
  800. with   dark   squares  growing  to  fill  the  plane  without  the
  801. laternating  light squares.  Spiral-Dot looks quiet similar to the
  802. Halftone-A matrix 0 degree rotated.
  803.  
  804.  
  805.  
  806.             Horizontal  - <number of colors>
  807.             Vertical    - <number of colors>
  808.             FwdDiagonal - <number of colors>
  809.             BckDiagonal - <number of colors>
  810.  
  811.  
  812. A  wide  range  of  special  effects clustered dither matrices are
  813. available  in  the  graphic  arts  industry  and  all  are  easily
  814. simulated digitally.  The Line dithers are such dithers.
  815.  
  816. The  horizontal  (as  well  as  the vertical, forward diagonal and
  817. backward  diagonal)  dither overcome much of the dot gain problems
  818. that the Floyd and Ordered dithers have with inexpensive printers.
  819. These  dithers  (especially  the  diagonal dithers) are especially
  820. good for large printings.
  821.  
  822.  
  823.                         Floyd Steinberg
  824.                         ---------------
  825.  
  826. This is a very popular error diffusion dither method suggested by
  827. Floyd and Steinberg. They argued that a filter with four elements
  828. was the smallest number that could produce "good" results. The
  829. values were choosen to particulary assure the checkerboard pattern
  830. at  the  middle  grey  or shade of color.  This dither method does
  831. provide  a good compromiss of speed and quality.  The reason for the
  832. popularity of this algorithem is clear, several color shade levels
  833. are    represented    by   pleasingly   isotropic,   structureless
  834. distributions  of  dots.   However,  some  shortcomings  are  also
  835. apparent:
  836.  
  837. 1. Correlated artifacts in many of the color shade level patterns.
  838. This can be easily seen by printing a grey scale ramp.
  839.  
  840. 2. Directional hysteresis due to the raster order of processing.
  841. This artifact is most apparent in very light and very dark
  842. patterns.
  843.  
  844. 3. Transient behavior near edges or boundaries.
  845.  
  846.                     Jarvis, Judice and Ninke
  847.                     ------------------------
  848.  
  849. In 1976 Jarvis, judice and Ninke reported an error filter with 12
  850. elements. The large filter size does reduce some of the artifacts
  851. seen with the 4 element filter of Floyd and Steinberg, but
  852. directional hysteresis in the very dark and light regions are
  853. increased, and pixels are clustered together more in the middle of
  854. color shade regions. It also sharpen the pictures more.
  855.  
  856.                             Stucki
  857.                             ------
  858.  
  859. The Stucki filter uses does provide nearly the same output as the
  860. Jarvis filter, though you may may notice differences in sharpness.
  861.  
  862.  
  863.                         Blue Noise 30%-50%
  864.                         ------------------
  865.  
  866. In trying several combinations of deterministic values in a four
  867. element error filter, non proved better than the famed filter of
  868. Floyd and Steinberg. Two variations of this basic filter are the
  869. Blue Noise dither included with CanonStudio. Both are processed
  870. with  serpentine rasters. The serpentine raster used in processing
  871. is responsible for much of the directional artifact elemination.
  872. The noisy treshold (30% or 50% white noise) breaks up most of the
  873. remaining stable texture patterns yielding good radial symmetry at
  874. the expense of adding some low frequency energy. 
  875.  
  876. Blue noise is specialy usefull when printing light shades and
  877. fading colors.
  878.  
  879. All  error  diffusion dither including Blue Noise can produce very
  880. good  results on color printers with little dot gain and very good
  881. registration.   If  it produces a washed out print or particularly
  882. bad patterns, then try another dither (see the custom Ordered-B or
  883. Halftone for instance).
  884.  
  885.  
  886.                           ARexx Interface
  887.                           ===============
  888.  
  889.  
  890. By  using  the powerful scripting language, ARexx, CanonStudio can
  891. be  controlled  for  automatic print jobs.  Nearly every aspect of
  892. CanonStudio can be controlled from ARexx using simple English-like
  893. commands.   This  chapter  describes the usage of CanonStudio from
  894. ARexx.
  895.  
  896. Note  that  you  must  have  ARexx  in order to use the facilities
  897. described  in  this  chapter.  Specifically, if the program cannot
  898. locate  the library "rexxsyslib.library", then it will not respond
  899. to  any  ARexx  style requests.  Also, CanonStudio must be startet
  900. with the REXX option (CLI or TOOLTYPE) to enable the ARexx port.
  901.  
  902.  
  903. In order to access CanonStudio from ARexx, you must tell ARexx how
  904. to  make  contact  with  CanonStudio.  Specifically, you must tell
  905. ARexx  the  name of the message port which CanonStudio creates for
  906. the purpose of ARexx interaction.
  907.  
  908. The  port name of the program is called "PRTSTUDIO.n" where "n" is
  909. an extension starting with "1" making the port unique.
  910.  
  911. Note:   the  name  "PRTSTUDIO"  is  not  an  ARexx  port unique to
  912. CanonStudio.   This port will also be used by similar programs for
  913. other  printer manufacturers.  They all use the same ARexx port and
  914. do  have  a common ARexx comand set so you can share ARexx scripts
  915. with those users.
  916.  
  917. You  can  make  the connection from ARexx to CanonStudio using the
  918. following ARexx command:
  919.  
  920.                         address "PRTSTUDIO.1"
  921.  
  922. ARexx  will  generate an error condition should CanonStudio not be
  923. found.
  924.  
  925. Note  that  the  ARexx  port  name  is  case specific.  It must be
  926. specified exactly as shown above.
  927.  
  928. Results:
  929. --------
  930.  
  931. After   every  command  directed  at  CanonStudio  from  ARexx  is
  932. executed,  CanonStudio  will  fill  in  the  standard ARexx result
  933. variable, "RC", with a return value.  If this value is 0, then the
  934. previous  command executed without error.  If the value of "RC" is
  935. not zero, then it contains an error severity indicator.
  936.  
  937. In  order  to  receive  additional error indications or to receive
  938. non-error  status  information  back  from  CanonStudio,  you must
  939. request   additional  status  information  from  ARexx  using  the
  940. following command:
  941.  
  942.                             OPTIONS RESULTS
  943.  
  944. This  command  must be one of the first executable instructions in
  945. your ARexx program.
  946.  
  947. If  an "options results" command has been issued, then CanonStudio
  948. will   load   additional   information  into  the  ARexx  variable
  949. "PRTSTUDIO_RESULT".   "PRTSTUDIO_RESULT" can be consulted whenever
  950. {\tt  RC}  is  non-zero  to  gain additional information about the
  951. nature of an error.
  952.  
  953. When  RC  is  returned  with  a  zero  value  (indicating no error
  954. occurred),  "PRTSTUDIO_RESULT"  will  be  set  to command specific
  955. information.   Note  that  this  means  you must check "RC" before
  956. depending    on    the    data    in    "PRTSTUDIO_RESULT"   since
  957. "PRTSTUDIO_RESULT" may contain either additional error information
  958. or the status information you requested.
  959.  
  960. The  "PRTSTUDIO_RESULT"  variable  is available only to true ARexx
  961. programs.   If you are sending ARexx style commands to CanonStudio
  962. from  a  non-ARexx  program,  then results which normally would be
  963. passed  back  in "PRTSTUDIO_RESULT" will instead be passed back in
  964. the "rm_Result2" field in the ARexx message structure.
  965.  
  966. When  CanonStudio is started with the REXX option, it will setup a
  967. database  of  your default values for printing.  The values of the
  968. database  can  than  be altered by using ARexx commands.  Once you
  969. have  setup  the values, you may call the PRINT command from ARexx
  970. and  CanonStudio will print the selected picture with the settings
  971. of  the  database.   You  can  go on with your ARexx script, while
  972. CanonStudio  prints  the  picture  in  background.   You  even may
  973. specify  an  unlimited  number  of  pictures for printing, while a
  974. CanonStudio is still printing the first picture.  CanonStudio does
  975. contain  a  printer  spooler  for keeping control of what has been
  976. printed (well, I would rather call this feature "Multitasking" ;-)
  977.  
  978. The  database  you  have  read  and/or  write access to from ARexx
  979. contains informations like:
  980.  
  981. PRINTDX  - print dimension x position in inch.
  982. PRINTDY  - print dimension Y position in inch.
  983. PRINTDW  - print dimension width in inch.
  984. PRINTDH  - print dimension height in inch
  985.  
  986. PAGEDX   - page dimension x position in inch.
  987. PAGEDY   - page dimension Y position in inch.
  988. PAGEDW   - page dimension width in inch.
  989. PAGEDH   - page dimension height in inch
  990.  
  991. PAPERDW  - printer page dimension width in inch - this value is read only!
  992. PAPERDH  - printer page dimension height in inch.
  993.  
  994. RULERDW  - ruler dimension width in inch.
  995. RULERDH  - ruler dimension height in inch.
  996.  
  997. COPIES    - numer of copies.
  998. STARTPAGE - starting page.
  999.  
  1000. DENSITY   - printer device density setting for printing
  1001.             DENSITY may range from 1 to 7.
  1002.  
  1003. DITHERMETHOD - dither method to use for printing
  1004.  
  1005. COLOR CONTROLS - control over the color adjustments.
  1006.  
  1007. and more...
  1008.  
  1009.  
  1010. Commands:
  1011. ---------
  1012.  
  1013. GETFILE
  1014. GETFILE "DEFAULTFILE"
  1015.  
  1016. Pops  up  the  filerequester  and  returns  the  selected  file in
  1017. "PRTSTUDIO_RESULT".   In  case  user aborted the requester without
  1018. selecting a file, RC will be set to 10 and "PRTSTUDIO_RESULT" does
  1019. contains the currently selected file.
  1020.  
  1021. SETFILE
  1022. SETFILE "PRINTFILE"
  1023.  
  1024. The first syntax returns the file set in the database. The second
  1025. syntax allows you to define a new picture for printing. The old
  1026. selection  will  be returned in "PRTSTUDIO_RESULT".  In both cases
  1027. no error is returned.
  1028.  
  1029. QUIT
  1030.  
  1031. Quits CanonStudio.
  1032.  
  1033. SCREENTOFRONT
  1034.  
  1035. Pops  the  CanonStudio  screen  to  front.   This command does not
  1036. return an error.
  1037.  
  1038. SCREENTOFRONT
  1039.  
  1040. Pushes  the CanonStudio screen to the back.  This command does not
  1041. return an error.
  1042.  
  1043. PANEL
  1044.  
  1045. Opens  the main processing window and allows the user to setup the
  1046. parameters  for  a  picture.   CanonStudio  returns  10  in RC and
  1047. "Aborted" in PRTSTUDIO_RESULT if the user aborted the panel window
  1048. with  cancel.   In  case an error appears or the selected file was
  1049. not a valid IFF file, RC contains 20 and PRTSTUDIO_RESULT "Illegal
  1050. file".
  1051.  
  1052.  
  1053. PRINTDW
  1054. PRINTDW SIZE
  1055. PRINTDH
  1056. PRINTDH SIZE
  1057. PRINTDX
  1058. PRINTDX SIZE
  1059. PRINTDY
  1060. PRINTDY SIZE
  1061. PAGEDW
  1062. PAGEDW SIZE
  1063. PAGEDH
  1064. PAGEDH SIZE
  1065. PAGEDX
  1066. PAGEDX SIZE
  1067. PAGEDY
  1068. PAGEDY SIZE
  1069. PAPERDW
  1070. PAPERDH
  1071. PAPERDH SIZE
  1072. RULERDW
  1073. RULERDH
  1074.  
  1075. Using  these  commands  you  can  ask  or set a size parameter for
  1076. printing.   SIZE  must  be defined in the actual measurement CM or
  1077. INCH.  Make sure you set the measurement previously.  In case SIZE
  1078. is  illegal,  PRTSTUDIO_RESULT returns "Illegal value" with RC set
  1079. to  10.   In case of an error, the size parameters in the database
  1080. are  altered to a legal value.  While you may alter a setting with
  1081. these  commands,  it's not recommended to set all parameters.  Use
  1082. the SETSIZE command instead.
  1083.  
  1084.  
  1085.  
  1086.  
  1087. SETSIZE PRINTDW PRINTDH PRINTDX PRINTDY PAGEDW PAGEDH PAGEDX PAGEDY PAPERDH
  1088.  
  1089. With  this  command you can set multiple print parameters with one
  1090. command.  You may specify as many arguments as you need as long as
  1091. you  conform the order above.  This command avoids possible errors
  1092. that  might  appear with the single size set commands (PRINTDW...)
  1093. because  of temporary invalid parameters.  As result, this command
  1094. returns the previous settings of:
  1095.  
  1096. PRINTDW PRINTDH PRINTDX PRINTDY PAGEDW PAGEDH PAGEDX PAGEDY PAPERDW PAPERDH
  1097.  
  1098. Note  that  you also get PAPERDW as result.  You may use the ARexx
  1099. parse  command  for  assigning each value to a wanted var in ARexx
  1100. scripts.
  1101.  
  1102. In  case  of an error, RC returns 10 and PRTSTUDIO_RESULT "Illegal
  1103. value".
  1104.  
  1105.  
  1106. CM
  1107.  
  1108. Sets the measurement to centimeters.  Automatically transforms the
  1109. values  in  the  database  to centimeters.  As result the previous
  1110. setting  "INCH" or "CM" is returned in PRTSTUDIO_RESULT.  No error
  1111. is reported.
  1112. NCH
  1113.  
  1114. Sets  the  measurement to inch.  Automaticly transforms the values
  1115. in the database to inch.  As result the previous setting "INCH" or
  1116. "CM" is returned in PRTSTUDIO_RESULT.  No error is reported.
  1117.  
  1118.  
  1119. FANFOLD
  1120.  
  1121. Sets  paper  type  to  fanfold.   As  result  the previous setting
  1122. "FANFOLD"  or  "SINGLE" is returned in PRTSTUDIO_RESULT.  No error
  1123. is reported.
  1124.  
  1125. SINGLE
  1126.  
  1127. Sets  paper  type  to  single.   As  result  the  previous setting
  1128. "FANFOLD"  or  "SINGLE" is returned in PRTSTUDIO_RESULT.  No error
  1129. is reported.
  1130.  
  1131. DITHER
  1132. DITHER CUSTOM|FLOYD|JARVIS|STUCKI|BNOISE30|BNOISE50
  1133.  
  1134. Sets  the requested dither method.  As result the previous setting
  1135. is  returned  in PRTSTUDIO_RESULT.  In case of an error, RC is set
  1136. to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1137.  
  1138. VERSION
  1139.  
  1140. Returns the current version of CanonStudio (ie. "1").
  1141.  
  1142.  
  1143. COPIES
  1144. COPIES NUMBER
  1145.  
  1146. Sets  the  amount  of  copies  to  print.   As result the previous
  1147. setting  is returned in PRTSTUDIO_RESULT.  In case of an error, RC
  1148. is set to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1149.  
  1150. STARTPAGE
  1151. STARTPAGE NUMBER
  1152.  
  1153. Sets  the  page  to  start  printing with.  As result the previous
  1154. setting  is returned in PRTSTUDIO_RESULT.  In case of an error, RC
  1155. is set to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1156.  
  1157. DENSITY
  1158. DENSITY 1-7
  1159.  
  1160. Set the print density.  As result the previous setting is returned
  1161. in  PRTSTUDIO_RESULT.   In  case  of an error, RC is set to 10 and
  1162. PRTSTUDIO_RESULT to "Illegal value".
  1163.  
  1164. MAGENTA
  1165. MAGENTA 0 - 100
  1166. YELLOW
  1167. YELLOW 0 - 100
  1168.  
  1169. Sets  the  ink  compensation.   As  result the previous setting is
  1170. returned  in  PRTSTUDIO_RESULT.  In case of an error, RC is set to
  1171. 10 and PRTSTUDIO_RESULT to "Illegal value".
  1172.  
  1173. RED
  1174. RED -50 - 50
  1175. GREEN
  1176. GREEN -50 - 50
  1177. BLUE
  1178. BLUE -50 - 50
  1179. GAMMA
  1180. GAMMA -50 - 50
  1181. CONTRAST
  1182. CONTRAST -50 - 50
  1183. BRIGHT
  1184. BRIGHT -50 - 50
  1185.  
  1186. Sets  the color adjustment values.  As result the previous setting
  1187. is  returned  in PRTSTUDIO_RESULT.  In case of an error, RC is set
  1188. to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1189.  
  1190. REDWEIGHT
  1191. REDWEIGHT   0 - 20000
  1192. GREENWEIGHT
  1193. GREENWEIGHT 0 - 20000
  1194. BLUEWEIGHT
  1195. BLUEWEIGHT  0 - 20000
  1196.  
  1197. Sets  the color weights for the color->greyscale transformation in
  1198. 1/100  percent.   As  result  the  previous setting is returned in
  1199. PRTSTUDIO_RESULT.   In  case  of  an  error,  RC  is set to 10 and
  1200. PRTSTUDIO_RESULT to "Illegal value".
  1201.  
  1202. CONTINUE
  1203.  
  1204. After this sending this command, the CanonStudio ARexx port is
  1205. removed and the program will pop up the file requester as if it
  1206. was started from CLI/Workbench without the REXX parameter. If
  1207. the user quits the filerequester, he also quits CanonStudio.
  1208.  
  1209. WARNING: do not send further messages after sending this command!
  1210.  
  1211. PRINT
  1212. PRINT WAIT
  1213.  
  1214. With  PRINT  the  currently  selected  file  will be placed in the
  1215. printing  queue  with  the  parameters  set  in the database.  The
  1216. control  is  returned  to  ARexx  directly  after  specifying this
  1217. command.   This  means,  the  ARexx  program  may go further while
  1218. CanonStudio  prints  in background.  Because of this, you'll never
  1219. receive  a  error message, wether the file was succesfully printed
  1220. or  not.   Though,  you  may  get  an error  in  RC  and  a proper
  1221. explanation in PRTSTUDIO_RESULT because of illegal settings in the
  1222. database.
  1223. Different to PRINT, PRINT WAIT does halt your ARexx program until
  1224. the  picture you specified has been printed.  In case the printing
  1225. was  aborted  by some reason, RC is set to 10 and PRTSTUDIO_RESULT
  1226. to "Aborted". Note: skiping the picture does not set RC to 10!
  1227.  
  1228. SETASPECT
  1229.  
  1230. Sets  the print dimension height (PRINTDH) according to the aspect
  1231. of the selected picture.
  1232. Note: to find out the aspect of a picture, CanonStudio has to scan
  1233. the picture file. Because of this, expect floppy users may have to
  1234. wait  some  seconds  until your ARexx program is further executed.
  1235. Also, a  valid picture file must be given
  1236. SETASPECT    returns    the   previously   selected   PRINTDH   in
  1237. PRTSTUDIO_RESULT.
  1238.